使用 kzb 文件

Kzb 文件包含 Kanzi Studio 工程的内容。要在设备上运行 Kanzi 应用程序，需要将其导出为 kzb 文件。

当用户启动 Kanzi 应用程序时，Kanzi 会加载一个或多个 kzb 文件的内容。当需要渲染内容时，Kanzi 会将内容加载到 RAM 和 GPU 内存中。请参阅资源管理。

您可以通过如下方式配置您的 Kanzi 应用程序：

• 在 C++ 应用程序中，使用 onConfigure() 函数。
• 在 application.cfg 中，使用或不使用 C++ 应用程序设置 Kanzi Studio 工程的参数。

请参阅应用程序配置参考。

要在 Windows 上运行 Kanzi 应用程序，您需要安装 Visual C++ Redistributable x86 for Visual Studio 2015。请参阅部署 Kanzi 应用程序到 Windows。

从 Kanzi Studio 工程创建 kzb 文件

要从 Kanzi Studio 工程创建 kzb 文件，请打开您的 Kanzi Studio 工程并选择 文件 (File) > 导出 (Export) > 导出 KZB (Export KZB)。

Kanzi Studio 会在 <ProjectName>/Application/bin 目录中创建以下文件：

• <project_name>.kzb 包含二进制格式的工程内容。
• <project_name>.kzb.cfg 包含 kzb 文件列表。如果您的 Kanzi 应用程序包含应用程序代码，Kanzi 默认会将 C++ 应用程序配置为加载文件中列出的二进制文件。
  

  configuration.binaryName = "<project_name>.kzb.cfg"

• （可选） <project_name>.kzb.txt 包含导出 kzb 文件中工程项的路径列表。您可以在应用程序代码中使用这些路径访问 Kanzi 应用程序的内容。
  要设置您是否要导出文件，请选择编辑 (Edit) > 用户首选项 (User Preferences) 并在高级 (Advanced) 选项卡中设置创建 kzb 文件的目录 (Create table of contents of kzb file)选项。
• （可选） <project_name>.kza 包含 XML 格式的工程。
  要创建文件，请在导出 kzb 文件之前选择 编辑 (Edit) > 用户首选项 (User Preferences)，并在 高级 (Advanced) 选项卡中启用 创建 kzb 文件的 XML 版本 (kza) (Create XML version (kza) of kzb file) 选项。

打开 kzb 文件

Kanzi 带有 kzb Player，您可以用于在 Windows 中打开 kzb 文件。例如，用 kzb Player 打开 kzb 文件，目检 kzb 文件中的内容。您可以在 <KanziInstallation>/Studio/Bin 目录中找到 kzb Player。

要在 Windows 上运行 Kanzi 应用程序，您需要安装 Visual C++ Redistributable x86 for Visual Studio 2015。请参阅部署 Kanzi 应用程序到 Windows。

要打开 kzb 文件：

1. 在 Kanzi Studio 主菜单中选择 文件 (File) > 导出 (Export) > 导出 KZB (Export KZB)。
   Kanzi Studio 从您的工程导出 kzb 文件。
2. 打开 /<KanziInstallation>/Studio/Bin/ 目录中的命令行并运行

   kzb_player_GL_vs2015_Release_DLL.exe "C:\KanziWorkspace_3_6_3_2514\Projects\MyProject\Binary\myproject.kzb"

设置 Kanzi 如何导入 kzb 文件

kzb 文件中是否包含 屏幕 (Screen) 决定了 Kanzi 如何加载 kzb 文件。

要设置 Kanzi Studio 是否将 屏幕 (Screen) 节点导出到相应工程的 kzb 文件中，在 工程 (Project) > 属性 (Properties) 中将 屏幕导出到 kzb (Export Screen to Kzb) 属性设置为：

• 启用导出包含 屏幕 (Screen) 节点的 kzb 文件。这是默认设置。您可以启动 kzb 文件中包含 屏幕 (Screen) 节点的 Kanzi 应用程序。如果您在应用程序运行时期间加载包含 屏幕 (Screen) 节点的 kzb 文件，会替换掉应用程序使用的 屏幕 (Screen) 节点。
• 禁止导出不包含 屏幕 (Screen) 节点的 kzb 文件。当应用程序已包含 屏幕 (Screen) 节点时，您只能在 Kanzi 应用程序运行时期间加载不包含 屏幕 (Screen) 节点的 kzb 文件。

另请参阅

使用脚本导出 kzb 文件

从文件系统加载图像

应用程序配置参考

资源管理

配置 Kanzi Studio 工程

打开导航